/*
 * Copyright 2009 XueSong Guo.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package cn.webwheel.database;

import java.sql.Connection;
import java.sql.PreparedStatement;
import java.sql.SQLException;

/**
 * inteface needed for dynamic sql method.<br/>
 * <b>example:</b>
 * <code><pre>
 * public interface SqlUtils {
 *   {@code @}Select("count(*) from ")
 *   int countTable(PreparedStatementProvider psp);
 * }
 * </pre></code>
 */
public interface PreparedStatementProvider {

    /**
     * PreparedStatement provider.
     * @param con current database connection
     * @param sql sql declared in Select or Update annotation
     * @return prepared statement
     * @throws SQLException sql exception
     */
    PreparedStatement get(Connection con, String sql) throws SQLException;
}
